home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 521 / runr150k / setup.hlp < prev    next >
Text File  |  1991-04-16  |  14KB  |  285 lines
  1.  
  2.                         Runner -- A Desktop Alternative
  3.  
  4.                                      SETUP
  5.  
  6.  
  7.                       Copyright (C) 1991 by Dave Thorson
  8.                       Version 1.50         March 10, 1991
  9.  
  10.  
  11.         
  12.         Runner v1.5 consists of the following files:
  13.  
  14.         
  15.         Program and Data Files
  16.  
  17.         RUNNER.PRG - the Runner program file
  18.         RUNNER.CFG - sample configuration file (note: unless your hard 
  19.            disk is set up exactly like mine, you cannot access programs 
  20.            from the menus in this file -- it's just included so you can 
  21.            get an idea how I use Runner every day)
  22.         RCONVERT.PRG  - Converts older RUNNER.CFG files for use with                   
  23.            newer versions (1.50 or higher) of Runner
  24.         RPICNAME.PRG - Easy way to assign default pictures for loading 
  25.            into Runner at startup
  26.  
  27.  
  28.         Documentation Files
  29.  
  30.         READ_ME.1ST - quick start notes for the impatient
  31.         OVERVIEW.HLP - Overview of Runner and related programs, 
  32.            shareware info, what's next?
  33.         RUNNER.HLP - displayed by pressing the HELP key from Runner's 
  34.            main menu; you may want to print it for reference.
  35.         NEWSTUFF.HLP - Summary of features, changes and fixes, by 
  36.            program version
  37.         SETUP.HLP - Description of Runner files and how to set them up 
  38.            (the very file you are reading now)
  39.         STARTUP.HLP - Tells how to start Runner and describes the main 
  40.            screen
  41.         MENU_BAR.HLP - Description of Runner's menu bar functions.
  42.         DIALOG.HLP - Explains the Description Dialog Box, including 
  43.            QuickKeys, Comment/Parameter line, and Installed Applications
  44.         FILSELCT.HLP - How to use file selector to run and view programs 
  45.            and files not in your menus
  46.         KEYBOARD.HLP - Keyboard equivalents and other keyboard functions 
  47.            including color changes, drive select and picture select
  48.         OTHERS.HLP - Instructions for MINI_RUN, REGIONS, RPICNAME, 
  49.            RCONVERT and any other related programs.
  50.  
  51.  
  52.         Picture and Picture Configuration Files
  53.         (all pictures by Dave Thorson except as noted below)
  54.  
  55.         INVASION.PC1 - Low res background pic
  56.         BORIS.PC1 - Low res background pic - I don't know who painted 
  57.            this copy of a Boris Vallejo pic (or is it just in his 
  58.            style?) but it does make a nice background!
  59.         WORMS.PC1 - Low res background pic
  60.         REGIONS1.PC1 - Low res background pic (demo for Regions)
  61.         FRIDGE.PC2 - Med res background pic
  62.         GRIDLAND.PC3 - High res background pic
  63.         INVASION.PC3 - High res background pic
  64.         REGIONS1.PI3 - High res background pic (demo for Regions)
  65.         GUIDE.PI1  - Template for designing low res pictures
  66.         GUIDE.PI2  - Template for designing medium res pictures
  67.         GUIDE.PI3  - Template for designing high res pictures
  68.         *.CF1 - Picture configuration files
  69.  
  70.  
  71.         The registered distribution disk, available only to those who 
  72.         register Runner for $10 or more, contains the above files and:
  73.  
  74.         MINI_RUN.TTP - Mini-Run program.
  75.         REGIONS.TTP - Regions program.
  76.         WARNING.HLP - Warns you that MINI_RUN.TTP and REGIONS.TTP are 
  77.            NOT shareware and have serial numbers assigned when you 
  78.            register Runner.  DO NOT give these files to others in any 
  79.            way or you will violate my copyright and Federal Law.  Your 
  80.            serial number can be reconstructed from data in these files.
  81.         ...plus any newer versions of Runner files.
  82.  
  83.  
  84.  
  85. $$      Installation
  86.  
  87.         Runner can be run from a hard disk or floppy disk, from any 
  88.         directory.  Copy the file RUNNER.PRG where you want to start it 
  89.         from (it CANNOT be placed in an AUTO folder).
  90.         
  91.         Runner stores most of its information in a configuration file 
  92.         called RUNNER.CFG.  An example RUNNER.CFG file is provided (play 
  93.         around with it, add and delete menu entries and so on, but don't 
  94.         expect any of the listed programs to run unless you have them 
  95.         stored in the same drive and folder names I use).  You can also 
  96.         create a new RUNNER.CFG file from scratch, within Runner, simply 
  97.         by saving your work before exiting Runner (select "Save config" 
  98.         from the "File" menu).  You can use names other than RUNNER.CFG 
  99.         but that's the filename Runner looks for when it starts.  Files 
  100.         with other names can be loaded from within Runner later (use the 
  101.         "Load config" option in the "File" menu).
  102.  
  103.                 
  104.         When you start Runner, it searches for RUNNER.CFG in the 
  105.         following sequence:
  106.         
  107.         1. in the current directory (folder), where RUNNER.PRG is
  108.         2. in the root directory (outside all folders) of the current 
  109.            disk (the disk RUNNER.PRG was loaded from)
  110.         3. in a folder in the root directory of the current disk called    
  111.            Runner (ex: D:\RUNNER\)
  112.  
  113.         
  114. $$      Home Directory   (IMPORTANT CONCEPT!)
  115.  
  116.         If RUNNER.CFG is found, that directory (folder) is assumed to be 
  117.         Runner's "home" directory.  Whenever you save or load a 
  118.         configuration file or load a picture file, Runner takes you to 
  119.         that directory by default.  If RUNNER.CFG is NOT found, then the 
  120.         root directory of the current drive becomes Runner's home 
  121.         directory.
  122.  
  123.         If you have MINI_RUN.TTP and REGIONS.TTP, they MUST also be 
  124.         placed in this home directory.  Runner won't find them anywhere 
  125.         else, and they CANNOT be run like other programs!
  126.         
  127.  
  128. $$      Picture Files
  129.         
  130.         After loading (or failing to find) RUNNER.CFG, Runner next looks 
  131.         for a picture file to load from Runner's home directory.  Runner 
  132.         can use any Degas-compatible (.PI1/.PI2/.PI3) or Degas-Elite 
  133.         compressed (.PC1/.PC2/.PC3) pictures as a background.  To 
  134.         autoload a picture when Runner starts, place one or more of 
  135.         these files in Runner's home directory: 
  136.  
  137.            RUNNER.PI1 for low resolution  (or RUNNER.PC1)
  138.            RUNNER.PI2 for medium resolution  (or RUNNER.PC2)
  139.            RUNNER.PI3 for high resolution  (or RUNNER.PC3)
  140.  
  141.         Use the pictures included with Runner (who knows what possessed 
  142.         me to paint them), or use the guide pictures provided to create 
  143.         your own.  The names above are used for automatically loading a 
  144.         background picture, so to autoload one of your own works of art, 
  145.         simply rename your picture to RUNNER.PIx ("x" is 1, 2 or 3) or 
  146.         RUNNER.PCx, as appropriate.  You should also rename any 
  147.         RUNNER.CFx (see below) file in the same manner.  There IS an 
  148.         easier way to define autoload pictures: Run the RPICNAME.PRG 
  149.         program and select the picture you want for each resolution.  
  150.         These names are written to RUNNER.PIx rather than picture data, 
  151.         and runner will load your selected pictures on startup.  See 
  152.         OTHERS.HLP for more information.
  153.  
  154.         If Runner cannot find the appropriate file for the current 
  155.         resolution, no picture is loaded.
  156.  
  157.         Note: if you hold down the Alternate or Control key when Runner 
  158.         starts, Runner will not look for a picture file to load.
  159.  
  160.         
  161. $$      Picture Configuration Files
  162.         
  163.         Starting with Runner v1.4, pictures could have configuration 
  164.         files associated with them, independent of the RUNNER.CFG files 
  165.         described above.  These files contain info on altered palettes, 
  166.         menu positions, and any REGIONS information for the picture.  
  167.         They derive their name from the picture's filename, and must be 
  168.         kept in the same directory as the picture file.  If you have a 
  169.         picture called E:\PICS\FLOWER.PC1, its associated configuration 
  170.         file would be E:\PICS\FLOWER.CF1.  The number (1, 2 or 3) 
  171.         matches the resolution number of the picture file, and CF stands 
  172.         for ConFiguration.  Picture config files are saved when you save 
  173.         your current Runner configuration, IF any picture-related data 
  174.         has been changed.  You can also force Runner to save only the 
  175.         picture configuration file (whether it needs to or not) by 
  176.         holding down the Alternate key when selecting "Save config" from 
  177.         the "File" menu.
  178.  
  179.         
  180. $$      Possible Setups
  181.         
  182.         I have Runner set up for my system as follows:
  183.  
  184.         Top (root) directory
  185.             of drive D:            Runner's "home" directory:
  186.  
  187.            D:\RUNNER.PRG              D:\RUNNER\RUNNER.CFG
  188.                                       D:\RUNNER\RUNNER.PI1
  189.                                       D:\RUNNER\RUNNER.CF1
  190.                                       D:\RUNNER\RUNNER.PI2
  191.                                       D:\RUNNER\RUNNER.CF2
  192.                                       D:\RUNNER\RUNNER.PI3
  193.                                       D:\RUNNER\RUNNER.CF3
  194.                                       D:\RUNNER\RUNNER.HLP
  195.                                       D:\RUNNER\MINI_RUN.TTP
  196.                                       D:\RUNNER\REGIONS.TTP
  197.                                       D:\RUNNER\RPICNAME.PRG
  198.  
  199.         RUNNER.PRG is in the root directory of drive D: (outside of any 
  200.         folders).  All other files are stored in a folder called Runner 
  201.         which appears in the window when drive D: is first opened from 
  202.         the desktop (it's a folder within the root directory of drive 
  203.         D:).  "D:\RUNNER\" is considered to be Runner's home directory 
  204.         in my setup.
  205.  
  206.  
  207.         For floppy disks, you may want a Runner disk with all the Runner 
  208.         files in the root directory.  This disk must be in the drive 
  209.         whenever you ask for help (or else your help request will be 
  210.         ignored).  On a two drive system you can keep MINI_RUN.TTP in 
  211.         the drive where Runner started, and put application disks in 
  212.         drive B.  Or, place Mini-Run in the root directory of your 
  213.         application disks in drive A (assuming you started Runner so 
  214.         that RUNNER.CFG was in the root directory of drive A).  Then 
  215.         Mini-Run will be found and can load your application.  Be sure 
  216.         to replace your Runner disk in drive A before exiting the 
  217.         application.  Of course, if you don't use Mini-Run then you 
  218.         don't need to mess with any of this....
  219.         
  220.         Floppy disk users may also want to keep Runner files in a 
  221.         "\RUNNER\" directory.  Once Runner locks in on "A:\RUNNER\" as 
  222.         its home directory, it doesn't care if you switch disks.  You 
  223.         could put RUNNER.PRG, RUNNER.CFG, and your startup picture files 
  224.         on one disk in a "\RUNNER\" directory.  Another disk could 
  225.         contain more picture files in a "\RUNNER\" directory.  Another 
  226.         could hold REGIONS.TTP, the .HLP files, and RPICNAME.PRG in its 
  227.         own "\RUNNER\" directory.  Finally, create a "\RUNNER\" 
  228.         directory on every disk containing a program you want use with 
  229.         Mini-Run, and place MINI_RUN.TTP in each of those folders (it's 
  230.         small, don't worry).  Runner will be able to find all these 
  231.         files even though you change disks.
  232.  
  233.         I use HeadStart (version 1.1) from the experts at CodeHead 
  234.         Software to start Runner whenever my ST is turned on.  A file 
  235.         called HEADSTRT.DAT goes in the root directory of my C: drive, 
  236.         and HEADST11.PRG is in the AUTO folder of the C: drive.  
  237.         HEADSTRT.DAT contains the line:
  238.  
  239.              D:\RUNNER.PRG
  240.  
  241.         HeadStart reads its data file, and loads Runner after the 
  242.         desktop appears.  I no longer need to open any desktop windows 
  243.         at all!  HEADST11.PRG is available on GEnie and possibly 
  244.         Compuserve, or contact CodeHead Software at: (213) 386-5735.  It 
  245.         may also be in the library of your local Atari User's Group.
  246.  
  247.  
  248.         
  249.         The only  * required *  files needed are RUNNER.PRG and your 
  250.         RUNNER.CFG file, although you may want the RUNNER.HLP file for 
  251.         on-line help, MINI_RUN.TTP to save space for larger programs, 
  252.         and your favorite background picture files and .CFx files....  
  253.         REGIONS.TTP is only needed if you want to create or edit screen 
  254.         regions and their functions, or save a background picture with 
  255.         the current colors -- it's not needed to use screen regions once 
  256.         you've saved them in a picture config file.
  257.  
  258.  
  259.                 
  260.         This ends the discussion on setting up Runner.  To get acquainted 
  261.         with using the program, you can try banging keys and selecting 
  262.         menu options, or you can read the following files in this 
  263.         recommended sequence (where have I seen this list before?):
  264.  
  265.         OVERVIEW.HLP - Overview of Runner and related programs, 
  266.            shareware info, what's next?
  267.         STARTUP.HLP - Tells how to start Runner and describes the main 
  268.            screen
  269.         MENU_BAR.HLP - Description of Runner's GEM menu bar functions 
  270.            (how to Load, Save, Add, Change, Drop, select color palettes 
  271.            and other useful goodies)
  272.         DIALOG.HLP - Explains the Description Dialog Box, including 
  273.            QuickKeys, Comment/Parameter line, and Installed Applications 
  274.            (you'll see this box anytime you add or change a program, 
  275.            menu or title)
  276.         FILSELCT.HLP - How to use file selector to run and view programs 
  277.            and files not in your menus
  278.         KEYBOARD.HLP - Keyboard equivalents and other keyboard functions 
  279.            including color changes, drive select and picture select
  280.         OTHERS.HLP - Instructions for MINI_RUN, REGIONS, RPICNAME, 
  281.            RCONVERT and any other related programs.
  282.         
  283.         
  284.         [end of file SETUP.HLP]
  285.